TBFinder is an opensource application that creates REALbasic versions of toolbox calls. It searches the "Univeral Headers" for the call you ask for, and translates it into RB syntax. In some cases, it also gives you comments explaining how to use the code.
TBFinder needs the C version of Universal Headers. If you don't want to locate it yourself the first time you run the app, place an alias of it in the same folder as TBFinder, and it will be automatically used.
Release notes:
v2.0
by Fabian Lidman and Thomas Tempelmann
- The app now searches an internal Carbon database and finds out if the toolbox call searched for is supported under MacOS X.
- Fixed a couple of bugs
- Added an option to treat Handles as MemoryBlocks (useful if you intend to dereference them)
- Made the 16*16 icon look nicer
- Thomas added code that will correctly interpret some more 68k data types useful for low-level event handling.
v1.9
by Fabian Lidman and Guillaume Grenier
- App now handles "EXTERN_API_C" declarations properly.
- Made several GUI enhancements.
- Added an Info button (an earthglobe icon) in the Search Results that searches Apple's Developer web site for the TB call.
v1.8
by Fabian Lidman, with some help from Amar Sagoo:
•Prefs dialog added. You can now choose if you want the code to be in titlecase or lowercase, and choose which of the browser windows you like to use by default.
•The app is now excellent at finding the correct fragment for toolbox calls. If you're interested in how this works, look into the a "Frag" resource with the "TEXT" picker.
•GUI improvements.
•Fixed some bugs.
v1.7
by Andy Fuchs (19. Aug. 1999), Dan Vanderkam and Fabian Lidman
1) SMART BROWSER window added:
Most significantly is the addition of a new window. (Command-B is the shortkey)
Hold the optionkey down when clicking the 'Browse' button, if you want to have the former one.
Smart-Browser is a hierarchical browser for .h-files, TB-Calls and Declare-statements.
As of this writing it includes two Filter functions:
(a) You can select wether you want to show
- files (.h) - displayed as folders containing Toolbox calls
- Toolbox - calls (no files) displayed as folders containingDeclare statements
- For speed reasons you can limit the search for TB calls to currently opened folders
- For declare statements you can choose to include 68k code
(b) Filter shown items under several conditions:
- starts with
- ends with
- contains
You can also option-click an item to expand/collapse all items. (NOTE: this is slow and needs lots of memory)
You can drag and drop the Declare-statement to your code window
Double-clicking will copy it to the clipboard
NOTES:
If the SmartBrowser-Window is first opened and doesn't find an index, it creates an index called 'TBCalls'. You can set the name to anything you like, if you put that name into the window.property 'idxName'.
2) ADDED ABILITY TO LIMIT SEARCHES
There is a now a checkbox in the search window, allowing you to tell TBFinder to start the search in a specific file. If it's not found in that file, the other files are searched. This feature was added by Dan Vanderkam, and slightly improved by Fabian Lidman.
v1.6.2
by Thomas Tempelman and Fabian Lidman
-the browse feature in 1.6.1 didn't work for EXTERN_API headers, so different people tried to provide fixes for this. Here is a version that works with both new and old UH versions.
-works with pre 8.5 systems again.
v1.6.1 by Guillaume Grenier and Fabian Lidman
Guillaume provided some code that made the browser window work with all versions of Univeral Headers. The browser window now remembers previous size and position.
v1.6
Ben Thielker added an excellent feature - the ability to browse the header files separately and wiew their call definitions in a hierachial list wiew. Must be seen.
v1.5.5
Fixed bug that caused the application to crash on pre-8.5 systems.
v1.5.4, by various people
- Jakob Bock made a huge work and improved the interface a lot. Code is now syntax colored, you can drag the output, and you can reveal or open the header file from the results window.
- You no longer have to place an alias of universal headers in the same folder as TBFinder - you will be asked to select it if it isn't there.
- State of Include68k checkbox is now remembered. The app uses Thomas Tempelmann's TTsPrefsMgr class, a great utility for storing information in prefs files.
- The app now uses three of TTs plugins - they are all included in the source folder.
v1.5.3, by Thomas Tempelmann (Aug 8, 99)
- Improved (hopefully) the translation of C types into RB types.
- Added a checkbox (and menu item) to select whether 68K inline code should be added or not. If enabled, the types may differ a bit to be more precise, and RB 2.1 is required to compile for 68K (RB 2.0 does not handle 68K parm passing correctly).
- Fixed another bug introduced by my latest changes: The name of the declared method was often constructed from the first parameter instead of the function's name.
- The results window now also shows the header file's full path name.
- If searching for function names, optionally those with the extension "Sync" are found, too. For example, searching for "PBDelete" will find "PBDeleteSync".
- Search button is not correctly disabled if edit field is empty.
- Moved "Show Clipboard" menu item to the "Edit" menu, where it belongs, I think (see Finder's menu).
- Added visual feedback to clicking on the "Copy code" button
- Improved the BGImage draving class so that it automatically adopts to when the canvas gets resized.
- Allowed the Find and the Results dialog to be resized, and locked their items accordingly.
- The searched string is now displayed as the title in the results window.
v1.5.2, by misc people
Editfields now cut mutiline text pasted into them, and GUI works nicer. These improvements were made by Jakob Bock. Also, Ben Thielker created a class that draws the BGImage over a infinite area, so that the Clipboard window now can be resizable. Fixed bugs with corrupt INLINE codes, and function names sometimes being the name of the first parameter. TBFinder now also shows the name of the header in which the call was found, and attempts to guess in which PPC fragment the call is.
v1.5.1, by Thomas Tempelmann (Aug 4, 99)
- Bugfix in the changes made for v1.5: The Inline68K code, when containing more than one 2-byte code, contained "0x" and ", ", which did not belong there.
- Reverted the note that says, that the search is case sensitive, back to explaining that the search is not case sensitive. That means that the search is still not case sensitive, contrary to the (wrong) statement below about v1.5.
v1.5
Major search routine rewrite by Thomas Tempelmann <rb@tempel.org>. Can handle #pragma parameter declarations in the C code, produces nicer code (titlecase, no blank areas), some interface improvements. The new code uses case sensitive search.
v1.4
Can now properly handle files that don't have an INLINE declaration. Interface improvements. You can now show clipboard from within the app.
v1.3
Even better at guessing data types, can properly handle newest API files. And, a cooler interface, too! ;-)
v1.2.2
Now better at guessing return types and param types.
v1.2.1
Parser can now handle newer header files, that use "EXTERN_API" instead of "extern pascal".
v1.2
Fixed bug with const parameters getting the wrong name.
v1.1
Fixed bugs with ByRef parameters. Comments are now included if these is a need to extract data from a byref parameter declared as a ptr.
